home *** CD-ROM | disk | FTP | other *** search
/ Amiga ISO Collection / AmigaUtilCD2.iso / Programming / Misc / LK_V1.06.LHA / LK V1.06 / HELP / script.hlp < prev    next >
Encoding:
INI File  |  1994-11-01  |  3.3 KB  |  112 lines
  1. [LANGUAGE english; PARENT keywords; PAGE 11-98]
  2. [C;6;B]        Scripts supplied with lk
  3. [J;1;N]
  4.   Rather than always think on how to do this and that, lk \
  5. development system is given with some useful scripts. You \
  6. can modify then as required and create you own scripts.
  7.   The scripts given with lk have the 's' flag set. You \
  8. set that flag with your CLI instruction:
  9. [B]        PROTECT <filename> +S
  10. [B]This flag prevent the usage of the EXECUTE intruction \
  11. every time you call a script.
  12.  
  13.   There is a list of the available scripts:
  14. [L;3]
  15. [GOTO strip]            strip
  16. [GOTO fd2lib]            fd2lib
  17. [GOTO fd2offset]        fd2offset
  18. [J]
  19. [LABEL strip][B;5]  . strip <source> <destination>
  20. [B;1]
  21.   This script will ask to lk to load a file (which \
  22. has to be an executable) and save that file without \
  23. any kind of debug. All debugs, symbols and advisory \
  24. hunks are suppressed. The organization of the hunks \
  25. will remains the same.
  26.  
  27. [LABEL fd2lib][B;5]  . fd2lib
  28. [B;1]
  29.   Creates a library or a header file with the function \
  30. names defined within a description ('.fd') file.
  31. [INDENT 6]
  32.    1. ASM
  33.  
  34.         You can ask for an assembler include file. This \
  35. will create a text file with a list of reference. \
  36. Usuly assembler programmers uses the 'fd2offset' \
  37. script.
  38.  
  39. [B]        XREF   _<funcname>
  40. [B]
  41.    2. C
  42.  
  43.         You can ask for a C header file. This will create \
  44. a text file with a list of function reference. Because \
  45. the '.fd' files does not describe suffisiantly the \
  46. parameter types, only 'long' and 'void *' are \
  47. used. You may use VERBOSE and edit the resulting \
  48. file to provide the correct types.
  49.  
  50. [B]      extern long <funcname>(type,type,...);
  51. [B]
  52.    3. PASCAL
  53.  
  54.         You can ask for a Pascal header file. This will \
  55. create a text file with a list of function references. \
  56. Because the '.fd' files does not describe suffisiantly \
  57. the parameter types, only 'long' and '^long' are \
  58. used. You may use VERBOSE and edit the resulting file \
  59. to provide each function of the correct types.
  60.  
  61. [B]      extern Function <funcname>(a:type,b:type,...): long;
  62. [B]
  63.    4. OBJECT
  64.  
  65.         You can ask for an object file. In this case lk \
  66. generates a library (like Amiga.Lib) with each function \
  67. which can be called with a C like call, which means \
  68. that parameters are stacked. You can use the option \
  69. 'C' to have the corresponding function calls.
  70. [INDENT]
  71. [LABEL fd2offset][B;5]  . fd2offset
  72. [B;1]
  73.   Creates a library or a header file with the offset \
  74. generated from a description ('.fd') file.
  75. [INDENT 6]
  76.    1. ASM
  77.  
  78.         You can ask for an assembler include file. This \
  79. will create a text file with a list of offset.
  80.  
  81. [B]      _LVO<funcname>   =   <offset>
  82. [B]
  83.    2. C
  84.  
  85.         You can ask for a C header file. This will create \
  86. a text file with a list of #define.
  87.  
  88. [B]      #define _LVO<funcname>       <offset>
  89. [B]
  90.  
  91.    3. PASCAL
  92.  
  93.         You can ask for a PASCAL header file. This will \
  94. create a text file with a list of constants.
  95.  
  96. [B]      const _LVO<funcname> = <offset>;
  97. [B]
  98.  
  99.    4. OBJECT
  100.  
  101.         You can ask for an object file. In this case lk \
  102. generates a library (not like Amiga.Lib) with each \
  103. function offset defined as an XDEF. The correspong \
  104. assembler programme would be:
  105.  
  106.             XDEF  _LVO<funcname>
  107.       _LVO<funcname>     =   <offset>
  108.  
  109.   See also:
  110. [L;3][LINK with]            WITH
  111. [LINK paths]                WITHPATH
  112.